home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / bbs / maxsutils.lha / MaxUtils / Today.lha / TODAY / readme next >
Text File  |  1994-03-13  |  4KB  |  87 lines
  1.  
  2. Today In History V1.0 by Jon Radoff
  3. -----------------------------------
  4.  
  5. This is a Today in history program which may be used to give something
  6. interesting to look at while you are booting up your system, or as a
  7. a text file which could be displayed on a bulletin board system.
  8.  
  9. This program uses data files which are based on a data format 
  10. and content used by Patrick Kincaid in his program TODAY-PC.
  11.  
  12. To run Today in History, you need to have previously assigned a logical
  13. directory named "TODAY:" and have put all of the data files in this
  14. directory.  The data files it will be looking for are the Today.* files
  15. (where * is all the three letter month extenders, such as AUG for August).
  16.  
  17. Just type "Today" at the CLI or have the command executed in a script file.
  18. Today in History will then think for a few seconds, and then display some
  19. text outlining a bunch of important dates from history that happened on the
  20. same date as today.
  21.  
  22. To run Today in History in a BBS environment, you'll need to have a way to
  23. execute a script file at a daily maintenance time...  With the Paragon BBS
  24. system, this is easily done by editing your event scheduler accordingly to
  25. add a script file which is run around midnight.  This script file should
  26. contain a couple of lines somewhat like this:
  27.  
  28. assign TODAY: dh1:today              ;Assign Today's logical directory
  29. Today >dh1:bbs/bulletins/Bul3.TXT    ;Redirect Today's screen to bulletin #3
  30.  
  31. To add a date to Today In History's data files, find the file which you
  32. need to add the date to by looking at the Today data file extenders (AUG for
  33. August, SEP for September, etc).
  34.  
  35. You may then add a line in the following format:
  36.  
  37. S06071839 The Hawaiian Declaration of Rights is signed.
  38. ^ ^ ^  ^ ^ ^
  39. | | |  | | |
  40. | | |  | | +- The text to be displayed on this date.
  41. | | |  | |
  42. | | |  | +- Qualifier field (*)
  43. | | |  |
  44. | | |  +- Year.  Put in leading zeros if less than the year 1000.
  45. | | |
  46. | | +- Day of the month, requires leading 0 if it is less than 10.
  47. | |
  48. | +- Month, requires leading 0 if it is less than 10.
  49. |
  50. +- A character which may be '*', 'S', 'R', or 'B'.  Anything starting with a
  51.    '*' is ignored.  'S' means the date is a special event.  'R' means it is
  52.    an annual type event (like a holiday).  'B' means it is a birthday.
  53.  
  54.  * The qualifier field is normally a space, however, it may be a few other
  55.    things as well:  When it is the letter "C", it means that it is a
  56.    continuation from the previous date, so the year field should not be
  57.    redisplayed.  It may also be a number from 0 to 6 for a day of the week
  58.    on which this will only be shown on (0 is Sunday, 1 is Monday, etc.).
  59.    See the November data file to see some good examples of this (it shows
  60.    how the U.S. Election Day can be correctly determined).
  61.  
  62.  
  63. This is another public domain utility by myself...  So far, my only other
  64. PD program for the Amiga is ParseLst, the Amiga version of the popular
  65. MS-DOS FidoNet nodelist compiler.
  66.  
  67. Also, don't miss the Paragon BBS system, coming very soon.  Zmodem with
  68. CRC-32, batch, and resume, full FidoNet support, online Doors, and much more.
  69.  
  70.  
  71. I may be contacted in the following ways:
  72.  
  73. PLINK:     Jon Radoff
  74. BBS:       508/393-3875
  75. FidoNet:   Jon Radoff @ 1:322/545 
  76. US Mail:   Jon Radoff, 18 Charina Road, Northboro, MA 01532
  77.  
  78.  
  79. NOTE.... I started writing this program myself and compiling a massive
  80. database to go along with it. One of my users mentioned that TODAY already
  81. existed... and since it was as friendly as it was... I decided to just
  82. incorporate MY database with his. Thanks Jon!!!
  83.  
  84. Chuck Maier
  85. TAG BBS 302-764-3186
  86.  
  87.